home *** CD-ROM | disk | FTP | other *** search
/ TPUG - Toronto PET Users Group / TPUG Users Group CD / TPUG Users Group CD.iso / C64 / R-Shows / (c)woc xi 93.d64 / ace-r4.doc < prev    next >
Text File  |  2007-02-11  |  8KB  |  195 lines
  1. ┴├┼-128/64 RELEASE 4  [╬OVEMBER 1, 1992].
  2.  
  3. ┴├┼ IS A PROGRAM FOR THE ├OMMODORE 128 AND ├OMMODORE 64 THAT PROVIDES A
  4. COMMAND SHELL ENVIRONMENT THAT IS SIMILAR TO THE ╒NIX'S.  ╔T IS STILL IN THE
  5. DEVELOPMENT STAGE, BUT ╔ THOUGHT ╔ WOULD RELEASE WHAT ╔ HAVE BEEN WORKING
  6. ON TO GET SOME PUBLIC REACTION.
  7.  
  8. ╘HE DISTRIBUTION CONSISTS OF SIX PROGRAMS:
  9.  
  10. ACE128   - THE ┴├┼ "KERNEL" FOR THE ├-128
  11. ACE64    - THE ┴├┼ "KERNEL" FOR THE ├-64
  12. SH       - THE COMMAND SHELL ITSELF
  13. CP       - A FILE COPIER PROGRAM
  14. RM       - A FILE SCRATCHER PROGRAM
  15. UUENCODE - A UUENCODER PROGRAM
  16. UUDECODE - A UUDECODER PROGRAM
  17.  
  18. ╘HIS FILE CONTAINS THESE BINARY PROGRAMS IN A UUENCODED ARCHIVE FORMAT.  ╘HE
  19. UUDECODE PROGRAM INCLUDED HERE WILL DECODE THIS FORMAT OF ARCHIVE, BUT THAT IS
  20. PROBABLY OF NO USE TO YOU UNLESS YOU ARE ABLE TO ├ATCH 22.  ┘OU WILL HAVE TO
  21. USE THE UUDECODER ON YOUR ╒NIX SYSTEM OR USE "UUXFER" FOR THE ├64.  ┘OU WILL
  22. PROBABLY HAVE TO SPLIT THE UUARCHIVE UP INTO SEPARATE FILES FOR UUDECODING.
  23.  
  24. ╬OTE THAT THE "ACE128" AND "ACE64" PROGRAMS ARE FUNCTIONALLY IDENTICAL, EXCEPT
  25. THAT ONE IS SET UP FOR THE 128 AND THE OTHER FOR THE 64.  ╘HUS, ALL OF THE
  26. APPICATION BINARY PROGRAMS WILL WORK WITH EITHER "ACE128" OR "ACE64".  ╠╧┴─
  27. AND ╥╒╬ THE APPROPRIATE KERNEL PROGRAM TO START THE SYSTEM.
  28.  
  29. ╘HE ┬UDDY ASSEMBLER SOURCE CODE FILES ARE NOT INCLUDED HERE, BUT ╔ WILL ┼MAIL
  30. THEM TO ANYONE WHO ASKS FOR THEM.
  31. --------------------------------------------------------------------------------
  32. ╬OW FOR THE DOCUMENTATION ITSELF, WHAT THERE IS OF IT:
  33.  
  34. ╫HEN ┴├┼ STARTS, IT LOADS AND EXECUTES THE COMMAND SHELL, GIVES YOU A PROMPT
  35. AND WAITS FOR YOU TO GIVE IT A COMMAND.  ┴ COMMAND HAS THE FOLLOWING FORMAT:
  36.  
  37. PROGRAMNAME ARG1 ARG2 ... ARG╬
  38.  
  39. ╘HE PROGRAMNAME CAN BE ANY OF THE FOLLOWING BUILT-IN COMMANDS:
  40.  
  41. ECHO       - PRINT THE GIVEN ARGUMENTS TO STDOUT
  42. CLS        - CLEAR THE SCREEN
  43. DIRECTORY  - CLEAR THE SCREEN AND GIVE A LONG-FORM DIRECTORY LISTING
  44. DIR        - SAME AS "DIRECTORY"
  45. D          - GIVE A LONG-FORM DIRECTORY LISTING
  46. LS         - GIVE A MULTI-COLUMN SHORT-FORM DIRECTORY LISTING
  47. CLSL       - COMBINATION OF "CLS" AND "LS"
  48. CD         - CHANGE THE CURRENT *─┼╓╔├┼*
  49. G          - SAME AS "CD"
  50. CAT        - DISPLAY THE NAMED FILES TO STDOUT
  51. TYPE       - SAME AS "CAT"
  52. T          - SAME AS "T"
  53. EXIT       - EXIT FROM THE COMMAND SHELL BACK TO ┬┴╙╔├
  54. X          - SAME AS "EXIT"
  55. DOS        - GIVE A ├OMMODORE DOS COMMAND TO THE CURRENT DEVICE (╧╨┼╬1,DV,15..)
  56. PATH       - SET THE PATH TO SEARCH FOR SEARCHING FOR EXTERNAL PROGRAMS
  57. SH         - INVOKE THE SHELL AGAIN AS A SUB-SHELL
  58.  
  59. OR PROGRAMNAME CAN BE FOR ANY OF THE EXTERNAL PROGRAMS PROVIDED WITH THIS
  60. DISTRIBUTION OTHER THAN "ACE" AND "SH".
  61.  
  62. ╘HE EXTERNAL PROGRAM ARGUMENTS ARE AS FOLLOWS:
  63.  
  64. CP       - SOURCEFILE DESTFILE
  65.          - FILE1 FILE2 ... FILE╬ DIRECTORYNAME
  66. RM       - FILE1 FILE2 ... FILE╬
  67. UUENCODE - FILE1 FILE2 ... FILE╬
  68. UUDECODE - FILE1 FILE2 ... FILE╬
  69.  
  70. ╘HE UUENCODE PROGRAM SENDS ITS OUTPUT TO STDOUT, SO YOU WILL USUALLY WANT TO
  71. REDIRECT STDOUT TO A DISK FILE.
  72.  
  73. ╘HE UUDECODE PROGRAM WILL ACCEPT EITHER ╨ETSCII OR ┴SCII FILES AND IS ABLE TO
  74. EXTRACT MULTIPLE FILES FROM ONE INPUT FILE.  ┼XTRACTED FILES ARE PUT INTO ╨╥╟
  75. FILES.
  76. --------------------------------------------------------------------------------
  77. ╘HE THREE ╒NIX STANDARD FILES ARE SUPPORTED:
  78.  
  79. STDIN    - WHERE THE DEFAULT INPUT COMES FROM (USUALLY THE KEYBOARD)
  80. STDOUT   - WHERE THE DEFAULT OUTPUT GOES TO (USUALLY THE SCREEN)
  81. STDERR   - WHERE ERROR MESSAGES ARE SENT TO (USUALLY THE SCREEN)
  82.  
  83. ╘O TEMPORARALLY REDIRECT THESE STANDARD FILE STREAMS FOR THE EXECUTION OF
  84. A COMMAND, YOU CAN USE THE FOLLOWING INCANTATIONS ON A COMMAND LINE:
  85.  
  86. <INFILE     - REDIRECT STDIN - INPUT TAKEN FROM "INFILE"
  87. >OUTFILE    - REDIRECT STDOUT - OUTPUT PUT INTO FILE "OUTFILE"
  88. >>OUTFILE   - REDIRECT STDOUT - SAME AS ">" BUT THE OUTPUT IS APPENDED TO FILE
  89. >!ERRFILE   - REDIRECT STDERR - ERROR OUTPUT IS PUT INTO "ERRFILE"
  90. >>!ERRFILE  - REDIRECT STDERR - ERROR OUTPUT IS APPENDED TO FILE "ERRFILE"
  91. --------------------------------------------------------------------------------
  92. ╫HENEVER YOU SPECIFY A FILE, YOU USE A "PATHNAME".  ╨ATHNAMES HAVE THE
  93. FOLLOWING OPTIONAL PARTS:
  94.  
  95. [DEVICE:][RAMLINK-DIRECTORY:][FILENAME]
  96.  
  97. ─EVICE NAMES ARE AS FOLLOWS:
  98.  
  99. "0:"  - ├OMMODORE DEVICE #0 - THE KEYBOARD - INPUT ONLY
  100. "1:"  - ├OMMODORE DEVICE #1 - THE CASSETTE DRIVE - NEVER TRIED IT MYSELF
  101. "2:"  - ├OMMODORE DEVICE #2 - THE MODEM - NEVER TRIED IT MYSELF
  102. "3:"  - ├OMMODORE DEVICE #3 - THE SCREEN - OUTPUT ONLY
  103. "4:"  - ├OMMODORE DEVICE #4 - THE PRINTER - OUTPUT ONLY
  104. "A:"  - ├OMMODORE DEVICE #8 - A DISK DRIVE - INPUT/OUTPUT
  105. "B:"  - ├OMMODORE DEVICE #9 - A DISK DRIVE - IF YOU HAVE >1 DRIVE
  106. ...
  107. "W:"  - ├OMMODORE DEVICE #30 - THE HIGHEST SERIAL DEVICE, ASSUMED TO BE DISK
  108. ".:"  - THE "CURRENT" DISK DEVICE
  109.  
  110. ╥AM╠INK (OR ╥AM─RIVE, ├═─ ╚ARD─RIVE) DIRECTORY NAMES HAVE THE FOLLOWING FORMATS:
  111.  
  112. "//DIR/:"                - A SUBDIRECTORY OF THE ROOT DIRECTORY
  113. "/DIR/:"                 - A SUBDIRECTORY OF THE CURRENT DIRECTORY
  114. "//DIR/DIR/ ... /DIR/:"  - A SUB-PATH OF THE ROOT DIRECTORY
  115. "/DIR/DIR/ ... /DIR/:"   - A SUB-PATH OF THE CURRENT DIRECTORY
  116.  
  117. ┴ND FILENAMES HAVE THE USUAL ├OMMODORE FORMAT OF 1 TO 16 CHARACTERS.
  118.  
  119. ╘HUS, THE FOLLOWING ARE VALID PATHNAMES FOR FILES:
  120.  
  121. 0:                    - THE KEYBOARD FOR INPUT
  122. 4:                    - THE PRINTER FOR OUTPUT
  123. B:FILE1               - "FILE1" ON DISK DEVICE #9
  124. .:FILE1               - "FILE1" ON THE CURRENT DISK DEVICE
  125. FILE1                 - "FILE1" ON THE CURRENT DISK DEVICE
  126. /DIR1/FILE1           - "FILE1" IN THE ╥AM╠INK SUBDIRECTORY "DIR1"
  127. A://DIR1/DIR2/:FILE1  - "FILE1" IN THE ╥AM╠INK SUBDIR "//DIR1/DIR2", DEVICE #8
  128.  
  129. ┴ND THE FOLLOWING ARE VALID PATHNAMES FOR DIRECTORIES:
  130.  
  131. A:               - DISK DEVICE #8 CURRENT DIRECTORY
  132. .:               - CURRENT DISK DEVICE'S CURRENT DIRECTORY      
  133. .://DIR1/:       - "DIR1" OFF THE ROOT DIRECTORY OF THE CURRENT ╥AM╠INK DEVICE
  134. /DIR1/DIR2/:     - SUBDIRECTORY "/DIR1/DIR2" OF THE CURRENT ╥AM╠INK DEVICE
  135.  
  136. ╬OTE THAT A DIRECTORY NAME ALWAYS ENDS WITH A ":".
  137.  
  138. ╘O GENERATE AN ┼╧╞ FOR KEYBOARD INPUT, ENTER A QUOTATION CHARACTER FOLLOWED BY
  139. A ├ONTROL-─ AND ╥┼╘╒╥╬ ON A BLANK LINE.
  140.  
  141. ┘OU MAY APPEND A ",P" OR ",S" OR ",U" TO A FILENAME TO SPECIFY WHETHER A ╨╥╟,
  142. ╙┼╤, OR ╒╙╥ FILE SHOULD BE ACCESSED/CREATED.  ┬Y DEFAULT, ┴├┼ WILL CREATE ╙┼╤
  143. FILES.
  144. --------------------------------------------------------------------------------
  145. ┴RGUMENTS THAT CONTAIN SPACES MUST BE PUT INTO QUOTES.  ═ULTIPLE QUOTED STRINGS
  146. CAN BE PLACED SIDE-BY-SIDE TO PRODUCE A LONGER STRING.  ╘HE FOLLOWING ARE
  147. EXAMPLES OF VALID COMMAND SHELL ARGUMENTS:
  148.  
  149. HELLO                                  -  HELLO
  150. 'HELLO'                                -  HELLO
  151. "HELLO THERE"                          -  HELLO THERE
  152. 'HELLO THERE'                          -  HELLO THERE
  153. 'SHE SAID, "HOW'"'S THAT"'"'' TO ME.'  -  SHE SAID, "HOW'S THAT" TO ME.
  154.  
  155. ├OMMAND SHELL ARGUMENTS ARE SEPARATED BY SPACES OR TAB CHARACTERS.
  156. --------------------------------------------------------------------------------
  157. ╘HE "PATH" COMMAND SETS OR DISPLAYS THE CURRENT SEARCH PATHNAMES FOR EXTERNAL
  158. PROGRAMS.  ┬Y DEFAULT THE PATHS TO SEARCH ARE "A:" AND ".:".  "PATH" ALONE ON
  159. A COMMAND LINE DISPLAYS THE CURRENT SEARCH PATH, AND "PATH" FOLLOWED BY
  160. ARGUMENTS WILL SET THE SEARCH PATH TO THE FOLLOWING ARGUMENTS.
  161. --------------------------------------------------------------------------------
  162. ╞UTURE ENHANCEMENTS:
  163.  
  164. - ╨UT "*" PATERN MATCHING INTO THE COMMAND SHELL.
  165. - ═AKE A RAMDISK FOR USE WITH ┴├┼.  ╥┴═─╧╙ IS NOT COMPATIBLE WITH ┴├┼.
  166. - ═ORE UTILITY PROGRAMS.
  167. - ═AKE AN AUTOEXEC.BAT TYPE OF MECHANISM.
  168. --------------------------------------------------------------------------------
  169. ╔F YOU HAVE QUESTIONS, COMMENTS, OR SUGGESTIONS YOU CAN CONTACT ME AT THE
  170. FOLLOWING ADDRESS:
  171.  
  172. -├RAIG ┬RUCE
  173. CSBRUCE@NEUMANN.UWATERLOO.CA
  174. "╤UOTING ╟OD AS YOU DISCUSS
  175.  ╫HAT IS RIGHT OR WRONG FOR US
  176.  ┘OU INUNDATE US WITH YOUR VIEWS
  177.  ┘OU TAKE AWAY MY RIGHT TO CHOOSE
  178.  ╙HOW ME WHAT SHOULD ╔ SEE
  179.  ═AKE MY MIND UP FOR ME." - ╞ROZEN ╟HOST
  180. --------------------------------------------------------------------------------
  181. ╘HE ├╥├32 VALUES FOR THE PROGRAMS ARE AS FOLLOWS:
  182.  
  183. ACE128     851441188
  184. ACE64     1479127354
  185. SH        4219226596
  186. CP        3763189395
  187. RM        2242673693
  188. UUENCODE  3909298339
  189. UUDECODE   501030069
  190.  
  191. ╔ WILL HAVE TO MAKE THE UUENCODE/UUDECODE PROGRAMS OPTIONALLY GENERATE/VERIFY
  192. THESE VALUES AUTOMATICALLY.
  193. --------------------------------------------------------------------------------
  194.  
  195.